////////////////////////////////////////////////
// DESCRIPTION:
//     Wrapper functions for device drivers to simplify
//     KernelIoControl calls
//
// Legal Notices:
//     Copyright (c) 2008, Telliam Consulting, LLC.
//     All rights reserved.
//
//     Redistribution and use in source and binary forms, with or without modification,
//     are permitted provided that the following conditions are met:
//
//     * Redistributions of source code must retain the above copyright notice,
//       this list of conditions and the following disclaimer.
//
//     * Redistributions in binary form must reproduce the above copyright notice,
//       this list of conditions and the following disclaimer in the documentation
//       and/or other materials provided with the distribution.
//
//     * Neither the name of Telliam Consulting nor the names of its contributors
//       may be used to endorse or promote products derived from this software
//       without specific prior written permission.
//
// Disclaimer:
//     THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
//     ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
//     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
//     IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
//     INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
//     BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
//     DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
//     LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
//     OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
//     OF THE POSSIBILITY OF SUCH DAMAGE.  
//

// Group = DFX Functions

#include <wtypes.h>
#include <ResMgr.h>
#include <FusionWare\DFX.h>

// DFX drivers always use the OS provided flag
//
extern BOOL FusionWare::InPowerHandler() { return IsInPwrHdlr(); }

///////////////////////////////////////////////////////
// Description: 
//    Requests a SYINTR for a specified IRQ
//
// Input: 
//    Irq      - IRQ to request a SYSINTR for
//    pSysIntr - pointer to new SYSINTR value
//
// Returns: 
//     BOOL DFXAPI 
//     
// Remarks: 
//     This function first requests the IRQ from the I/O resource manager
//     then requests the OAL to assign a SYSINTR for it.
//     The resource manager registry entries must be configured to indicated
//     that an IRQ is shared for multiple requests of the same IRQ to succeed
//
bool FusionWare::DFX::RequestSysIntr(DWORD Irq, DWORD* pSysIntr, DWORD Flags /* = 0*/)
{
    DWORD numRead;
    
    // try and allocate the irq from the resource manager first.
    if(!ResourceRequestEx(RESMGR_IRQ, Irq, 1, Flags))
        return false;

    return KernelIoControl(IOCTL_HAL_REQUEST_SYSINTR, &Irq, sizeof(Irq), pSysIntr, sizeof(*pSysIntr),&numRead)
           && numRead == sizeof(*pSysIntr);
}

bool FusionWare::DFX::ReleaseSysIntr(DWORD SysIntr)
{
    DWORD numRead;
    
    if(!ResourceRelease(RESMGR_IRQ, SysIntr, 1))
        return false;

    return 0!=KernelIoControl(IOCTL_HAL_RELEASE_SYSINTR, &SysIntr, sizeof(SysIntr), NULL, 0 ,&numRead);
}
